home *** CD-ROM | disk | FTP | other *** search
/ Business & Presentations / Business and Presentations - Volume 1 (1995)(Sideface)(NL).iso / drivers / dvips54 / dvips.doc < prev    next >
Text File  |  1990-11-25  |  32KB  |  793 lines

  1.  
  2.  
  3.  
  4. DVIPS(1)          Pyramid OSx Operating System           DVIPS(1)
  5.  
  6.  
  7.  
  8. NNAAMMEE
  9.      dvips - convert a TeX DVI file to PostScript (PostScript is
  10.      a trademark of Adobe Systems, Inc.)
  11.  
  12. SSYYNNOOPPSSIISS
  13.      dvips [ --cc _n_u_m ] [ --dd _n_u_m ] [ --ee _n_u_m ] [ --ff ] [ --hh _f_i_l_e ] [
  14.      --ll _n_u_m ] [ --mm ] [ --nn _n_u_m ] [ --oo _f_i_l_e ] [ --pp _n_u_m ] [ --qq ] [
  15.      --rr ] [ --ss ] [ --tt _m_o_d_e_n_a_m_e ] [ --xx _n_u_m ] [ --CC _n_u_m ] [ --DD _n_u_m ]
  16.      [ --FF ] [ --KK ] [ --NN ] [ --PP _p_r_i_n_t_e_r_n_a_m_e ] [ --UU ] [ --XX _n_u_m ] [
  17.      --YY _n_u_m ] [ --ZZ ] [ --?? ] _f_i_l_e[.dvi]
  18.  
  19. DDEESSCCRRIIPPTTIIOONN
  20.      The program ddvviippss converts a DVI file _f_i_l_e[.dvi] produced by
  21.      TeX (or by some other processor like GFtoDVI) and converts
  22.      it to PostScript, normally sending the result directly to
  23.      the laserprinter.  The DVI file may be specified without the
  24.      ._d_v_i extension.  Fonts used may either be resident in the
  25.      printer or defined as bitmaps in PK files, or a `virtual'
  26.      combination of both.  If the MMaakkeeTTeeXXPPKK program is installed,
  27.      ddvviippss will automatically invoke METAFONT to generate fonts
  28.      that don't already exist.
  29.  
  30. OOPPTTIIOONNSS
  31.      Boolean flags that are turned on by certain letters (such as
  32.      -r to reverse pages) can be turned off by following the
  33.      option immediately with a 0 (as in -r0).  The options that
  34.      this can be used with are ffmmqqrrFFKKNNUUZZ.  The command line
  35.      switches are:
  36.  
  37.      --cc _n_u_m
  38.           Generate _n_u_m copies of every page.  Default is 1. (For
  39.           collated copies, see the --CC option below.)
  40.  
  41.      --dd _n_u_m
  42.           Set the debug flags.  This is intended only for emer-
  43.           gencies or for unusual fact-finding expeditions; it
  44.           will work only if ddvviippss has been compiled with the
  45.           DEBUG option.  The file _d_e_b_u_g._h in the sources indi-
  46.           cates what the values of _n_u_m can be.  Use a value of -1
  47.           for maximum output.
  48.  
  49.      --ee _n_u_m
  50.           Make sure that each character is placed at most this
  51.           many pixels from its `true' resolution-independent
  52.           position on the page. The default value of this parame-
  53.           ter is resolution dependent (it is the number of
  54.           entries in the list [100, 200, 300, 400, 500, 600, 800,
  55.           1000, 1200, 1600, 2000, 2400, 2800, 3200, ...] that are
  56.           less than or equal to the resolution in dots per inch).
  57.           Allowing individual characters to `drift' from their
  58.           correctly rounded positions by a few pixels, while
  59.           regaining the true position at the beginning of each
  60.  
  61.  
  62.  
  63. Printed 11/25/90          9 August 1990                         1
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. DVIPS(1)          Pyramid OSx Operating System           DVIPS(1)
  71.  
  72.  
  73.  
  74.           new word, improves the spacing of letters in words.
  75.  
  76.      --ff   Run as a filter.  Read the DVI file from standard input
  77.           and write the PostScript to standard output.  The stan-
  78.           dard input must be seekable, so it cannot be a pipe.
  79.           If you must use a pipe, write a shell script that
  80.           copies the pipe output to a temporary file and then
  81.           points dvips at this file.
  82.  
  83.      --hh _n_a_m_e
  84.           Prepend file _n_a_m_e as an additional header file. (How-
  85.           ever, if the name is simply `-', suppress all header
  86.           files from the output.)  This header file gets added to
  87.           the PostScript userdict.
  88.  
  89.      --ll _n_u_m
  90.           The last page printed will be the first one numbered
  91.           _n_u_m. Default is the last page in the document.
  92.  
  93.      --mm   Specify manual feed for printer.
  94.  
  95.      --nn _n_u_m
  96.           At most _n_u_m pages will be printed out.  Default is
  97.           100000.
  98.  
  99.      --oo _n_a_m_e
  100.           The output will be sent to file _n_a_m_e. If no file name
  101.           is given, the default name is _f_i_l_e.ps; if this option
  102.           isn't given, the default name is !lpr.  If the first
  103.           character of the file name is an exclamation mark, then
  104.           the remainder will be used as an argument to popen;
  105.           thus, specifying !lpr as the output file will automati-
  106.           cally queue the file for printing.
  107.  
  108.      --pp _n_u_m
  109.           The first page printed will be the first one numbered
  110.           _n_u_m. Default is the first page in the document.
  111.  
  112.      --qq   Run in quiet mode.  Don't chatter about pages con-
  113.           verted, etc.; report nothing but errors to stderr.
  114.  
  115.      --rr   Stack pages in reverse order.  Normally, page one will
  116.           be printed first.
  117.  
  118.      --ss   Causes the entire global output to be enclosed in a
  119.           save/restore pair.  This causes the file to not be
  120.           truly conformant, and is thus not recommended, but is
  121.           useful if you are driving the printer directly and
  122.           don't care too much about the portability of the out-
  123.           put.
  124.  
  125.      --tt _m_o_d_e_n_a_m_e
  126.  
  127.  
  128.  
  129. Printed 11/25/90          9 August 1990                         2
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136. DVIPS(1)          Pyramid OSx Operating System           DVIPS(1)
  137.  
  138.  
  139.  
  140.           This sets the mode to _m_o_d_e_n_a_m_e.  Currently, the only
  141.           modes allowable are: lleetttteerr, which selects _l_e_t_t_e_r size
  142.           (8.5 by 11 inch page); aa33, which selects _a_3 size; aa44,
  143.           which selects _a_4 size; lleeggaall, which selects _l_e_g_a_l size
  144.           (8.5 by 14 inches); lleeddggeerr, which selects _l_e_g_a_l size
  145.           (11 by 17 inches); llaannddssccaappee, which rotates the docu-
  146.           ment by ninety degrees.  The default page size is
  147.           _l_e_t_t_e_r.  The llaannddssccaappee option may be combined with any
  148.           of the others; doing so requires giving the --tt option
  149.           twice.  The upper left corner of each page in the DVI
  150.           file is placed one inch from the left and one inch from
  151.           the top.
  152.  
  153.      --xx _n_u_m
  154.           Set the magnification ratio to _n_u_m /1000. Overrides the
  155.           magnification specified in the DVI file.  Must be
  156.           between 10 and 100000.
  157.  
  158.      --CC _n_u_m
  159.           Create _n_u_m copies, but collated (by replicating the
  160.           data in the PostScript file).  Slower than the --cc
  161.           option, but easier on the humans.
  162.  
  163.      --DD _n_u_m
  164.           Set the resolution in dpi (dots per inch) to _n_u_m. This
  165.           affects the choice of bitmap fonts that are loaded and
  166.           also the positioning of letters in resident PostScript
  167.           fonts. Must be between 10 and 10000.  This affects both
  168.           the horizontal and vertical resolution.
  169.  
  170.      --FF   Causes control-D (ASCII code 4) to be appended as the
  171.           very last character of the PostScript file.  This is
  172.           useful when ddvviippss is driving the printer directly, as
  173.           is common on extremely small systems, instead of work-
  174.           ing through a spooler.
  175.  
  176.      --KK   Removes comments from included graphics files.  Only
  177.           necessary when using brain-damaged spoolers or
  178.           PostScript postprocessors that don't properly interpret
  179.           structured comments.
  180.  
  181.      --NN   Turns off structured comments; this might be necessary
  182.           on some systems that try to interpret PostScript com-
  183.           ments in weird ways, or on some PostScript printers.
  184.  
  185.      --PP _p_r_i_n_t_e_r_n_a_m_e
  186.           Sets up the output for the appropriate printer.  This
  187.           is implemented by reading in _c_o_n_f_i_g._p_r_i_n_t_e_r_n_a_m_e, which
  188.           can then set the output pipe (as in, o !lpr -Pprinter-
  189.           name)